home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_cnvt / conv53 / convert.com (.txt) next >
Encoding:
Graham's TXT2COM  |  1990-07-26  |  7.2 KB  |  141 lines
  1.     CONVERTS.DOC  Version 5.3
  2.  
  3.     Elizabeth Anne VanderPutten, Ph.D.
  4.     Office of Information Systems
  5.     National Science Foundation
  6.     Washington, D.C.
  7.  
  8.  
  9.     Syntax: CONVERTS <cr>
  10.  
  11.     Purpose:
  12.  
  13.     CONVERTS reads a file downloaded from DB2 and creates a second
  14.     file in any of the following formats:
  15.  
  16.             dBASE III + database
  17.             Lotus 1-2-3 worksheet
  18.             Word Perfect mail merge
  19.             Comma delimited ASCII
  20.  
  21.     The original file is unchanged.
  22.  
  23.     CONVERTS supports the DOS PATH designations.
  24.  
  25.     Contents:
  26.  
  27.             CONVERTS.EXE             main program
  28.             CONVERT.COM              self reading copy of document
  29.             LICENSE.COM              self reading copy of license
  30.  
  31.     Requirements:
  32.  
  33.             IMPORTANT:  The file to be converted must be downloaded
  34.             fron the DB2 database using QMF ONLY.  DO NOT use TSO!
  35.  
  36.             DO use only the simplest possible downloading procedure!
  37.  
  38.             Also, you obviously need enough disk space for the
  39.             new dBASE III+, Lotus, Mail Merge, or ASCII text file,
  40.             plus enough space for CONVERTS' workfile.
  41.  
  42.     Operation:
  43.  
  44.             At the DOS prompt type CONVERTS <cr>
  45.  
  46.             CONVERTS loads and asks for the name of the file you wish
  47.             to convert. After checking the input file, CONVERTS asks
  48.             you to select the type of output file you want.
  49.  
  50.             It warns you of any problems or unusual conditions as it
  51.             processes your file.
  52.  
  53.             CONVERTS then reads your input file, makes a temporary
  54.             workfile, produces your dBASE file and cleans up after
  55.             itself.  As it processes your data, CONVERTS tells you
  56.             what it is doing.  When finished, it tells you how long
  57.             it took and displays you new file statistics.
  58.  
  59.     PROBLEMS:
  60.  
  61.           o Wrong File Type
  62.  
  63.             1. When CONVERTS first starts, it checks for the QMF
  64.             signature in the file and, if missing, gives a message
  65.             telling you it is the wrong type of file.
  66.  
  67.             To correct this problem, download the file again from
  68.             DB2.
  69.  
  70.             2.  A file set to "Read Only" also causes CONVERTS to
  71.             issue a "wrong file type" message.  (See "Read Only Input
  72.             File" below.)
  73.  
  74.           o Field Width Determination
  75.  
  76.             In determining the structure of the input file, CONVERTS
  77.             attempts to verify the field width information provided
  78.             by DB2/QMF.  If there are problems, CONVERTS may ask
  79.             you for more information.
  80.  
  81.             The best way to avoid problems it to make sure to download
  82.             you data using the simplest bare bones QMF procedure.
  83.  
  84.           o Duplicate Field Names
  85.  
  86.             A second problem that could arise is duplicate field
  87.             names in the dBASE file.  This could happen if the first
  88.             10 characters of two or more DB2 field names happen to
  89.             be the same.  The reason is that field names in DB2 may
  90.             be up to 15 characters long.  CONVERTS uses the first 10
  91.             of these for its dBASE field names.
  92.  
  93.             It is often possible to correct this problem simply by
  94.             loading the file into dBASE and using the MODIFY
  95.             STRUCTURE command to change the name of one of the
  96.             duplicate field names.
  97.  
  98.           o Unexpected End-of-File Marker
  99.  
  100.             A corrupt file is another problem.  CONVERTS attempts to
  101.             verify the file's integrity by reading it.  If CONVERTS
  102.             finds an ASC 26 character anywhere in your file, it takes
  103.             that as an end-of-file marker and stops loading data.
  104.  
  105.             You can ususally tell if this has happened by looking at
  106.             the statistics for your new file which include the number
  107.             of records loaded.
  108.  
  109.             To correct this problem, check the file with a text
  110.             editor like QEDIT.  Ask it to replace all occurances of
  111.             ASC 026 with ASC 032.  With QEDIT, the relevant keys are
  112.             Ctrl-Q-A, i.e., press Ctrl-Q and at the <more> prompt
  113.             enter the letter A.  At the "Search For:" prompt, hold down
  114.             the ALT key and, using the number pad, enter the digits
  115.             026.  Release the Alt key and press Enter.  At the
  116.             "Replace with" prompt, hold down the ALT key and enter the
  117.             digits 032 on the KEY pad.  Finally, at the "Options"
  118.             prompt enter GIN (for Global, Ignore case, No-don't
  119.             ask).  Save the file by pressing Alt-X and Y to save.
  120.  
  121.             Start CONVERTS again.
  122.  
  123.           o Read Only Input File
  124.  
  125.             An unlikely problem is an error message indicating a
  126.             wrong file type even though the file has been properly
  127.             downloaded.
  128.  
  129.             This will occur if your input file is set to "Read
  130.             Only." To correct this problem, see "ATTRIB" in a DOS
  131.             manual or call the network administrator.
  132.  
  133.             Example:
  134.  
  135.             C:\DOS\ATTRIB -R filespec   where filespec is the
  136.                                         filename including path (if
  137.                                         needed) and extension.
  138.  
  139.     July 26, 1990
  140.  
  141.